SendControlMessage

SendControlMessage
Header:	Controls.h		Carbon status:	Supported

Sends a message to a control definition function.

SInt32 SendControlMessage (
    ControlRef inControl, 
    SInt16 inMessage, 
    SInt32 inParam
);

inControl: A handle to the control that is to receive a low-level message.
inMessage: A bit field representing the message(s) you wish to send; see ControlDefProcPtr.
inParam: The message-dependent data passed in the param parameter of the control definition function.

function result: Varying data, depending upon the message sent in the inMessage parameter.

DISCUSSION

Your application does not normally need to call the SendControlMessage function. If you have a special need to call a control definition function directly, call SendControlMessage to access and manipulate the control’s attributes.

Before calling SendControlMessage, you should determine whether the control supports the specific message you wish to send by calling GetControlFeatures and examining the feature bit field returned. If there are no feature bits returned that correspond to the message you wish to send (for messages 0 through 12), you can assume that all system controls support that message.

VERSION NOTES

This function is available with Appearance Manager 1.0 and later.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.